Crate kvarn_quinn_proto

Low-level protocol logic for the QUIC protoocol

quinn-proto contains a fully deterministic implementation of QUIC protocol logic. It contains no networking code and does not get any relevant timestamps from the operating system. Most users may want to use the futures-based quinn API instead.

The quinn-proto API might be of interest if you want to use it from a C or C++ project through C bindings or if you want to use a different event loop than the one tokio provides.

The most important types are Endpoint, which conceptually represents the protocol state for a single socket and mostly manages configuration and dispatches incoming datagrams to the related Connection. Connection types contain the bulk of the protocol logic related to managing a single connection and all the related state (such as streams).

Modules

• congestion
  Logic for controlling the rate at which data is sent
• crypto
  Traits and implementations for the QUIC cryptography protocol
• transport_parameters
  QUIC connection transport parameters

Structs

• AckFrequencyConfig
  Parameters for controlling the peer’s acknowledgement frequency
• ApplicationClose
  Reason given by an application for closing the connection
• Chunk
  A chunk of data from the receive stream
• Chunks
  Chunks
• ClientConfig
  Configuration for outgoing connections
• Connection
  Protocol state and logic for a single QUIC connection
• ConnectionClose
  Reason given by the transport for closing the connection
• ConnectionEvent
  Events sent from an Endpoint to a Connection
• ConnectionHandle
  Internal identifier for a Connection currently associated with an endpoint
• ConnectionId
  Protocol-level identifier for a connection.
• ConnectionStats
  Connection statistics
• Datagram
  An unreliable datagram
• Datagrams
  API to control datagram traffic
• Endpoint
  The main entry point to the library
• EndpointConfig
  Global configuration for the endpoint, affecting all connections
• EndpointEvent
  Events sent from a Connection to an Endpoint
• FrameStats
  Number of frames transmitted of each frame type
• IdleTimeout
  Maximum duration of inactivity to accept before timing out the connection.
• MtuDiscoveryConfig
  Parameters governing MTU discovery.
• PathStats
  Statistics related to a transmission path
• RandomConnectionIdGenerator
  Generates purely random connection IDs of a certain length
• RecvStream
  Access to streams
• RttEstimator
  RTT estimation for a particular network path
• SendStream
  Access to streams
• ServerConfig
  Parameters governing incoming connections
• StreamId
  Identifier for a stream within a particular connection
• Streams
  Access to streams
• Transmit
  An outgoing packet
• TransportConfig
  Parameters governing the core QUIC state machine
• TransportError
  Transport-level errors occur when a peer violates the protocol specification
• TransportErrorCode
  Transport-level error code
• UdpStats
  Statistics about UDP datagrams transmitted or received on a connection
• UnknownStream
  Error indicating that a stream has not been opened or has already been finished or reset
• VarInt
  An integer less than 2^62
• VarIntBoundsExceeded
  Error returned when constructing a VarInt from a value >= 2^62
• Written
  Indicates how many bytes and chunks had been transferred in a write operation

Enums

• ConfigError
  Errors in the configuration of an endpoint
• ConnectError
  Errors in the parameters being used to create a new connection
• ConnectionError
  Reasons why a connection might be lost
• DatagramEvent
  Event resulting from processing a single datagram
• Dir
  Whether a stream communicates data in both directions or only from the initiator
• EcnCodepoint
  Explicit congestion notification codepoint
• Event
  Events of interest to the application
• FinishError
  Reasons why attempting to finish a stream might fail
• ReadError
  Errors triggered when reading from a recv stream
• ReadableError
  Errors triggered when opening a recv stream for reading
• SendDatagramError
  Errors that can arise when sending a datagram
• Side
  Whether an endpoint was the initiator of a connection
• StreamEvent
  Application events about streams
• WriteError
  Errors triggered while writing to a send stream

Constants

• DEFAULT_SUPPORTED_VERSIONS
  The QUIC protocol version implemented.

Traits

• BytesSource
  A source of one or more buffers which can be converted into Bytes buffers on demand
• ConnectionIdGenerator
  Generates connection IDs for incoming connections